package com.xiliubit.cloudpicture.service;

import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.xiliubit.cloudpicture.model.dto.user.UserAddRequest;
import com.xiliubit.cloudpicture.model.dto.user.UserEditRequest;
import com.xiliubit.cloudpicture.model.dto.user.UserQueryRequest;
import com.xiliubit.cloudpicture.model.dto.user.UserRegisterRequest;
import com.xiliubit.cloudpicture.model.entity.User;
import com.baomidou.mybatisplus.extension.service.IService;
import com.xiliubit.cloudpicture.model.vo.UserInfoVO;
import com.xiliubit.cloudpicture.model.vo.UserLoginVO;

import javax.servlet.http.HttpServletRequest;
import java.util.List;

/**
* @author 86173
* @description 针对表【user(用户)】的数据库操作Service
* @createDate 2025-07-27 20:34:23
*/
public interface UserService extends IService<User> {
    /**
     * 用户注册
     *
     * @param userRegisterRequest 用户注册信息
     * @return 新用户 id
     */
    long userRegister(UserRegisterRequest userRegisterRequest);

    /**
     * 用户登录
     *
     * @param userAccount  用户账户
     * @param userPassword 用户密码
     * @param request      登录请求
     * @return 脱敏后的用户信息
     */
    UserLoginVO userLogin(String userAccount, String userPassword, HttpServletRequest request);

    /**
     * 获取当前登录用户
     *
     * @param request 请求
     * @return 用户信息
     */
    User getLoginUser(HttpServletRequest request);


    /**
     * 获取当前登录用户
     *
     * @param request 请求
     * @return 用户登陆态是否移除
     */
    boolean userLogout(HttpServletRequest request);

    /**
     * 用户信息修改(VO)
     * 用户修改自己的信息
     *
     * @param userEditRequest 用户信息修改请求
     * @return 修改后的用户信息
     */
    boolean userEdit(UserEditRequest userEditRequest, User loginUser);

    /**
     * 管理员添加用户
     *
     * @param userAddRequest 新增用户信息
     * @return 新增用户ID
     */
    Long userAdd(UserAddRequest userAddRequest);

    /**
     * 获取用户信息
     *
     * @param id 用户id
     * @return 脱敏后的用户信息
     */
    UserInfoVO getUserById(Long id);

    /**
     * 获取脱敏后的用户
     *
     * @param user 用户
     * @return 脱敏后的用户
     */
    UserInfoVO getUserInfo(User user);

    /**
     * 获取脱敏后的用户列表
     *
     * @param  userList 未脱敏的用户列表
     * @return 脱敏后的用户列表
     */
    List<UserInfoVO> getUserVOList(List<User> userList);

    /**
     * 对登录用户脱敏
     *
     * @param user 当前用户
     * @return 脱敏后的用户信息
     */
    UserLoginVO getLoginUser(User user);

    /**
     * 获取查询条件
     *
     * @param userQueryRequest 查询条件
     * @return 查询条件
     */
    QueryWrapper<User> getQueryWrapper(UserQueryRequest userQueryRequest);

    /**
     * 是否为管理员
     *
     * @param user 登陆用户
     * @return 是否为管理员
     */
    boolean isAdmin(User user);
}
